home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1997 May / EnigmA AMIGA RUN 18 (1997)(G.R. Edizioni)(IT)[!][issue 1997-05][EAR-CD II].iso / softwareupdate / picasso96 update / p96emu.lha / README < prev   
Text File  |  1997-04-04  |  5KB  |  93 lines
  1. MagicSNs Picasso96 Emulation Library
  2. ====================================
  3.  
  4. About the Emulation Library
  5. ---------------------------
  6.  
  7. Well, as most of you probably know, Picasso96 is a new WB Emulation in the
  8. tradition of CyberGraphX. It even emulates CyberGraphX, so all CyberGraphX
  9. programs run on Picasso 96.
  10.  
  11. The Emulation does not run on the Cybervision/3D, though. I mailed to the
  12. programmers of Picasso96 before, and there i heard that there probably
  13. will NEVER be Picasso96 Support for the Cybervision/3D. The problem was
  14. that Phase 5 did not lend those guys a CV/3D Board for 2 weeks (they would
  15. need a Board for 2 weeks to support it with P96) and so there won't be
  16. P96 for CV/3D.
  17.  
  18. I mailed in this time a lot with one of the P96 programmers, in connection
  19. with my rtgmaster.library project that i finally made running also on
  20. Picasso96, without even having Picasso96 installed :) But as to P96 for
  21. CV/3D there were no news :(
  22.  
  23. Then there came two uploads to Aminet : Trapped-2 for Picasso96, a RPG style
  24. game, and "Partyhall", a Graphics Demo based on Picasso96. Both are works
  25. by Michael Piepgras, BTW. Now i am REALLY a fan of games and demos, and that
  26. i should not be able to run the first REAL GFX BOARD DEMO (no Anim) on my
  27. system REALLY made me frustrated. So i decided to write a Picasso96 Emulation
  28. for CyberGraphX.
  29.  
  30. Some words about the word "Emulation". This "Emulation" provides you with
  31. Direct Access to the Video RAM and all that stuff, just like the Original
  32. Picasso96, so it should not be slower than the Original Picasso96. It runs
  33. on *ALL* CyberGraphX Systems, not only the Cybervision/3D, and you do not
  34. have to change your WB Emulation to use Picasso96 programs anymore. Programs
  35. using WritePixelArray might be SLIGHTLY slower, due to emulation overhead,
  36. but not much. The emulation is not "complete", though, some of the most
  37. exotic features of P96 are not emulated. But all programs i tested up to now
  38. ran. If this library finds an unimplemented feature, it simply ignores it,
  39. no crashes or such.
  40.  
  41. How to install it
  42. -----------------
  43.  
  44. Simply copy Picasso96API.library to libs: !!! NEVER install this library
  45. to a *REAL* Picasso96 system, this library is only the CyberGraphX version
  46. of the Picasso96API.library, not the real Picasso96API.library
  47.  
  48. Differences to the real Picasso 96
  49. ----------------------------------
  50.  
  51. Not implemented yet : p96ReadTrueColorData, p96WriteTrueColorData
  52. Not tested yet      : p96AllocBitmap,p96FreeBitmap,p96ReadPixelArray
  53.  
  54. Other differences :
  55.  
  56. The FormatsAllowed/FormatsForbidden-Feature is not implemented for the Screenmode-Requester
  57. and for the BestMode-Function. It is implemented for the AllocMode-Function, though.
  58. The RenderFunc/SaveFunc-Feature is not implemented yet (and i do not have
  59. an idea of how to implement it at all !!!)
  60. The Nomemory/NoSprite/UserData Features are not implemented yet. Partially
  61. i do not know what that features do, partially i do not know how to implement it.
  62. The DisplayID,PubScreenName and Window Tags in the Screenmode-Requester are not
  63. implemented, as the CyberGraphX Screenmode-Requester does not support them.
  64. I am not sure if i understood the Bitsperpixel-Feature of the Attribute Functions
  65. correctly (and i do not have a real Picasso96 system to check, how the real one
  66. behaves). If you try to get the boardnumber with the attribute functions, you
  67. will always get a 1, independent of the REAL value.
  68.  
  69. WritePixelArray/ReadPixelArray only support the formats supported by CyberGraphX
  70. for these calls (LUT8/ARGB/RGBA/RGB) and not all those provided by Picasso96.
  71. I am not sure how the real Picasso96 behaves with a Screen where neither P96SA_RGBFormat
  72. nor P96SA_DisplayID are defined. Then of course the Screenmodenames will be those
  73. of CyberGraphX, not those of Picasso96.
  74.  
  75. Asides from that Picasso96 is fully emulated. I hope no a**hole will use the
  76. knowledge about the unimplemented stuff to let his stuff only run on the real
  77. Picasso96 ... after all, this emulation library is the ONLY WAY to let Picasso96
  78. run on the Cybervision/3D, and the CV/3D was a quite well-selling board !!!
  79.  
  80. Tested programs
  81. ---------------
  82.  
  83. I tested all demo programs provided with the Picasso96 Developper package.
  84. With the exception of WriteTrueColorData they all ran (WriteTrueColorData did
  85. not run, as it uses one of the still unimplemented call, but i hope to make it running,
  86. soon. I did not yet test Trapped-2 and Partyhall, but will do so soon :).
  87.  
  88. I do NOT guarantee, that this emulation library will run with all Picasso96 Software,
  89. but i HOPE that it will. Bear in mind, that this software was created WITHOUT ANY
  90. POSSIBILITY to check the behaviour of the REAL Picasso96 !!!
  91.  
  92. MagicSN
  93.